/**
 * 版权所有(C)，上海海鼎信息工程股份有限公司，2007，所有权利保留。
 * 
 * 项目名：	rumba
 * 文件名：	MainFrameService.java
 * 模块说明：	
 * 修改历史：
 * Dec 19, 2007 - lxm - 创建。
 */
package com.hd123.rumba.gwt.entry.client;

import java.util.List;

import com.google.gwt.core.client.GWT;
import com.google.gwt.user.client.rpc.ServiceDefTarget;
import com.hd123.rumba.gwt.base.client.RBRemoteService;
import com.hd123.rumba.gwt.base.client.exception.ClientBizException;
import com.hd123.rumba.gwt.entry.client.menu.QMenu;

/**
 * 应用程序主界面框架 | 远程服务 | 接口类
 * 
 * @author lxm
 * 
 */
public interface MainFrameService extends RBRemoteService {
  
  public static class Locator {
    
    private static MainFrameServiceAsync service = null;
    private static final String SERVICE_URL = "RB/mainFrame";
    
    public static MainFrameServiceAsync getService() {
      if (service == null) {
        service = (MainFrameServiceAsync) GWT.create(MainFrameService.class);
        ServiceDefTarget endpoint = (ServiceDefTarget) service;
        String moduleRelaUrl = GWT.getModuleBaseURL() + SERVICE_URL;
        endpoint.setServiceEntryPoint(moduleRelaUrl);
      }
      return service;
    }
  }

  /**
   * 取得当前登录用户主菜单的顶级菜单项列表。
   * 
   * @return
   * @throws ClientBizException
   * @gwt.typeArgs <com.hd123.rumba.gwt.entry.client.menu.QMenuItem>
   */
  public List getTopMenuItems() throws ClientBizException;

  /**
   * 取得当前登录用户主菜单中指定子菜单树。
   * 
   * @param parentItemId
   *          指定的上级菜单项ID。允许null，表示取得整个菜单树。
   * @return
   * @throws ClientBizException
   */
  public QMenu getSubMenu(String parentItemId) throws ClientBizException;
}
